Reference: copyProc

copyProc clones a filter's configuration.

Prototype

int copyProc(FilterActivation *fa, const FilterFunctions *ff, void *dst);

Parameters:
    fa        Pointer to filter activation structure
    ff        Pointer to callback function structure
    dst       Memory block to copy clone into

Return value:
    No return value.

Exceptions:
    No exceptions should be thrown from this function.

Requirements:
    Function may be omitted, in which case a byte-by-byte copy is used.

Host support:
    VirtualDub 1.4.11 (API V8)

Remarks

This function allows you to implement a copy constructor for your filter, which then allows you to store pointers to allocated and destructable objects in your filter structure. To do this, you must tie copyProc to your class's copy constructor, initProc to your regular constructor, and deinitProc to your destructor. See using a class object for your filter for more details.

[up] back to main page


VirtualDub external filter SDK 1.05©1999-2001 Avery Lee <phaeron@virtualdub.org>